Filter hook '{$type}_template_hierarchy'
in WP Core File wp-includes/template.php at line 62
Description
Filters the list of template filenames that are searched for when retrieving a template to use. The dynamic portion of the hook name, `$type`, refers to the filename -- minus the file extension and any non-alphanumeric characters delimiting words -- of the file to load. The last element in the array should always be the fallback template for this query type. Possible hook names include: - `404_template_hierarchy` - `archive_template_hierarchy` - `attachment_template_hierarchy` - `author_template_hierarchy` - `category_template_hierarchy` - `date_template_hierarchy` - `embed_template_hierarchy` - `frontpage_template_hierarchy` - `home_template_hierarchy` - `index_template_hierarchy` - `page_template_hierarchy` - `paged_template_hierarchy` - `privacypolicy_template_hierarchy` - `search_template_hierarchy` - `single_template_hierarchy` - `singular_template_hierarchy` - `tag_template_hierarchy` - `taxonomy_template_hierarchy`
Occurrences
Filename |
Line Number |
wp-includes/template.php |
62 |
Parameters
Type |
Name |
Description |
string[] |
$templates |
A list of template candidates, in descending order of priority. |
PHP Doc
/**
* Filters the list of template filenames that are searched for when retrieving a template to use.
*
* The dynamic portion of the hook name, `$type`, refers to the filename -- minus the file
* extension and any non-alphanumeric characters delimiting words -- of the file to load.
* The last element in the array should always be the fallback template for this query type.
*
* Possible hook names include:
*
* - `404_template_hierarchy`
* - `archive_template_hierarchy`
* - `attachment_template_hierarchy`
* - `author_template_hierarchy`
* - `category_template_hierarchy`
* - `date_template_hierarchy`
* - `embed_template_hierarchy`
* - `frontpage_template_hierarchy`
* - `home_template_hierarchy`
* - `index_template_hierarchy`
* - `page_template_hierarchy`
* - `paged_template_hierarchy`
* - `privacypolicy_template_hierarchy`
* - `search_template_hierarchy`
* - `single_template_hierarchy`
* - `singular_template_hierarchy`
* - `tag_template_hierarchy`
* - `taxonomy_template_hierarchy`
*
* @since 4.7.0
*
* @param string[] $templates A list of template candidates, in descending order of priority.
*/